home *** CD-ROM | disk | FTP | other *** search
/ Acorn Risc Technologies StrongARM CD-ROM / Acorn Risc Technologies StrongARM CD-ROM.iso / software / apps / creator / !Creator_Docs_Guide < prev    next >
Encoding:
Text File  |  1996-07-19  |  15.7 KB  |  473 lines
  1.  
  2. __________________
  3.  
  4. Creator user guide
  5. __________________
  6.  
  7.  
  8. User, please note
  9. =================
  10.  
  11. Creator is Shareware. It is not free software. You may freely use this
  12. program for a single 30 day trial period. After this trial period, you must
  13. decide whether or not you want to continue to use the program. If you don't,
  14. you must stop using the program and delete your copy. If you do, you must
  15. register your copy of the program with the author, paying a small
  16. registration fee. Refer to 'Registering' for details.
  17.  
  18. Please respect the rules of Shareware. Shareware programs like Creator have
  19. cost an awful lot of time and effort to build, will serve you well, and will
  20. cost you very little. If you register the Shareware you use, you will ensure
  21. that Shareware authors will continue to improve the software you use, and
  22. write exciting new Shareware software. If you don't register the Shareware
  23. you use, you are stealing money from Shareware authors, and they will stop
  24. writing Shareware, and start writing much more expensive commercial software
  25. instead.
  26.  
  27. Copyright notice
  28. ================
  29.  
  30. The copyright (c) of this program belongs to John Kortink. All rights are
  31. reserved.
  32.  
  33. You may not change this program (except for documented configuration
  34. changes). You may not use any part of this program in any other program or
  35. product without my written approval. You may spread this program freely, but
  36. only in complete and unchanged form, and only against bare distribution costs
  37. (if any). This program is provided 'as is'. No fitness of this program for
  38. any particular purpose is implied. Using this program is entirely at your own
  39. risk.
  40.  
  41.  
  42. //
  43. //
  44. // Introduction
  45. //
  46. //
  47.  
  48. Creator is a pixel image format convertor. It can perform direct conversions
  49. between a large number of image formats and image subformats.
  50.  
  51. Creator is extremely fast. All code, except for the WIMP interface, has been
  52. written in 100%, carefully optimized ARM assembly code.
  53.  
  54.  
  55. //
  56. //
  57. // Using Creator
  58. //
  59. //
  60.  
  61. Simply drag an image file to the Creator icon on the icon bar. If Creator
  62. recognizes the format of the image file, the 'Creator image' window will
  63. appear. The 'Creator image' window is described below.
  64.  
  65. Creator may be configured using its icon bar menu. Besides the usual 'Info'
  66. and 'Quit' icons, the 'Control' icon gives access to the 'Creator control'
  67. window (click on 'Control' to make the window permanent), and 'Status' gives
  68. access to the 'Status' menu. Both the 'Creator control' window and the
  69. 'Status' menu are described below.
  70.  
  71. //
  72. //
  73. // The 'Creator image' window
  74. //
  75. //
  76.  
  77. In this window, you will find two parts, called 'Input image' and 'Output
  78. image'.
  79.  
  80. The 'Input image' part refers to the image file you dragged to the Creator
  81. icon bar, and shows details of the input image. In addition :
  82.  
  83. - 'Options', for some image formats, allows you to specify 'load options',
  84.   which (mostly subtly) influence the way your input image is interpreted.
  85.   Refer to 'Supported image formats (detailed)' for information on specific
  86.   load options.
  87.  
  88. The 'Output image' part refers to the image file you are going to save, and
  89. allows you to specify the format of the output image. The choices that are
  90. available represent all possible conversions that Creator is capable of,
  91. given the format of the input image, as follows :
  92.  
  93. - 'Format' allows you to choose the image format.
  94. - 'Colours' allows you to choose the number of colours used.
  95. - 'Compression' allows you to choose the compression method used.
  96. - 'Options', for some image formats, allows you to specify 'save options',
  97.   which (mostly subtly) influence the way your output image is saved. Refer
  98.   to 'Supported image formats (detailed)' for information on specific save
  99.   options.
  100.  
  101. The 'Colours' field deserves some further explanation. This is displayed as
  102. 'x bit r:g:b type', where 'x' is the number of bits per pixel (referred to
  103. below as bpp), 'r', 'g', and 'b' are the number of bits of accuracy in a
  104. pixel colour of red, green, and blue respectively, and 'type' is the pixel
  105. colour type. There are essentially two pixel colour types :
  106.  
  107. - The 'palette' or 'grey' type indicates that pixel values are not pixel
  108.   colours themselves but indices into a pixel colour lookup table (called a
  109.   'palette'). The 'grey' pixel type also indicates that all palette colours
  110.   are greys.
  111. - The 'true' pixel type indicates that pixel values directly represent pixel
  112.   colours. Therefore, 'x' is always the addition of 'r', 'g' and 'b'.
  113.  
  114. Creator is capable of (and only of) all conversions in which the new bpp is
  115. equal to or higher than the old bpp. All other conversions would, in nearly
  116. all cases, cause loss of image colour resolution, and would require colour
  117. quantization and dithering, which Creator is not capable of currently.
  118.  
  119. After making all your choices, you can enter a filename in the 'Filename'
  120. field and drag the filetype icon to save the output image.
  121.  
  122.  
  123. //
  124. //
  125. // The 'Creator control' window
  126. //
  127. //
  128.  
  129. In this window, you will find one part, called 'R/G/B scaling'.
  130.  
  131. The 'R/G/B scaling' part allows you to select the way that pixel colours may
  132. be 'scaled'. 'Scaling' in this respect refers to changing the number of bits
  133. of accuracy of each primary colour (referred to below as 'bppc') in a pixel
  134. colour. This is needed if the accuracies used in the output image differ from
  135. the accuracies used in the input image.
  136.  
  137. Creator is capable of (and only of) all conversions in which, for all primary
  138. colours, the new bppc is equal to or higher than the old bppc. All other
  139. conversions would cause loss of image colour resolution, and would require
  140. colour quantization and dithering, which Creator is not capable of currently.
  141.  
  142. - 'Disallow' will disallow any bppc scaling.
  143. - 'Perfect' allows only 'Perfect' bppc scaling.
  144. - 'Discontinuous' allows 'Perfect' or 'Discontinuous' bppc scaling.
  145. - 'Limited' allows 'Perfect' or 'Limited' bppc scaling.
  146.  
  147. - 'Perfect' scaling is used if the new bppc is an integer multiple of the old
  148.   bppc. A new intensity value is a 'concatenating repeat' of the bits of the
  149.   old intensity value, as many times as will fit in the new bppc. As the new
  150.   bppc is an integer multiple of the old bppc, this results in retaining all
  151.   of the intensity scale dynamic, and preserves the equal intensity distances
  152.   between successive mapped old intensity values.
  153. - 'Discontinuous' scaling is used if the new bppc is greater than the old
  154.   bppc, but not by an integer multiple. It is like 'Perfect' scaling, except
  155.   that, as the new bppc is not an integer multiple of the old bppc, this does
  156.   result in retaining all of the intensity scale dynamic, but also results in
  157.   slightly varying intensity distances between successive mapped old
  158.   intensity values. I.e. the colour balance is slightly compromised.
  159. - 'Limited' scaling is used if the new bppc is greater than the old bppc, but
  160.   not by an integer multiple. A new intensity value is an appropriate
  161.   'upshift' of the bits of the old intensity value, the lower few bits are
  162.   always zero. This results in reducing the intensity scale dynamic, but
  163.   preserves the equal intensity distances between successive mapped old
  164.   intensity values. I.e. the image is slightly darker.
  165.  
  166. Note that the particular scaling option selected will affect the number of
  167. available conversion options. The more 'allowing' the scaling option is, the
  168. more conversion options will be available. Indeed, for some input images, no
  169. conversion options may be available at all in combination with 'Disallow' or
  170. 'Perfect' scaling.
  171.  
  172.  
  173. //
  174. //
  175. // The 'Status' menu
  176. //
  177. //
  178.  
  179. In this menu you can manipulate Creator's 'status', which consists of a
  180. number of configuration settings.
  181.  
  182. - 'Save' will save the current status.
  183. - 'Load' will load the saved status.
  184. - 'Default' will load the default status.
  185. - 'Kill' will remove the saved status.
  186.  
  187. When Creator starts up it loads the saved status, or the default status if
  188. there is no saved status.
  189.  
  190. The status consists of the 'R/G/B scaling' setting only.
  191.  
  192.  
  193. //
  194. //
  195. // Supported image formats (overview)
  196. //
  197. //
  198.  
  199. Creator can read the following image formats (in alphabetical order) :
  200.  
  201. - AIM
  202. - CadSoft
  203. - Clear
  204. - Degas
  205. - GIF
  206. - IFF
  207. - IMG
  208. - Irlam
  209. - JPEG
  210. - MacPaint
  211. - MTV
  212. - PBMPlus
  213. - PCX
  214. - Pineapple
  215. - QRT
  216. - Sprite
  217. - TIFF
  218.  
  219. Creator can write the following image formats (in alphabetical order) :
  220.  
  221. - Clear
  222. - GIF
  223. - JPEG
  224. - PBMPlus
  225. - Sprite
  226. - TIFF
  227.  
  228.  
  229. //
  230. //
  231. // Supported image formats (detailed)
  232. //
  233. //
  234.  
  235. Following are brief details of all supported image formats.
  236.  
  237. Image format interpreters are usually very complete, but may, in some cases,
  238. lack support for some subformats. All image interpreters have at least been
  239. tested successfully on all sample images I could find, and have been verified
  240. as well as possible against documentation available to me. Generally, if
  241. Creator encounters formats or subformats that cannot be recognized or are not
  242. supported, it will give up gracefully and provide an indication of why it has
  243. failed.
  244.  
  245. AIM
  246. ===
  247. Origin        : Acorn machines. !AIM (Archimedes Image Manager) program.
  248. Colours        : 8 bpp 8:8:8 grey
  249. Compression    : none
  250. Recognition    : filetype &004
  251. Miscellaneous    : Resolution always 256 x 256 pixels.
  252.  
  253. CadSoft
  254. =======
  255. Origin        : Acorn machines. Millipede Prisma display board.
  256. Colours        : 8 bpp 8:8:8 palette colour
  257. Compression    : none
  258.           runlength
  259. Recognition    : filetype &69A
  260.           'MILLIPEDE' at offset &10
  261.  
  262. Clear
  263. =====
  264. Origin        : Acorn machines. !Translator program and several hardware
  265.           vendors' programs.
  266. Colours        : 1,2,3,4,5,6,7,8 bpp 8:8:8 palette colour
  267.           24 bpp 8:8:8 true colour
  268. Compression    : none
  269. Recognition    : filetype &690
  270.  
  271. Degas
  272. =====
  273. Origin        : Atari machines. Degas and other programs.
  274. Colours        : 1,2,4 bpp 3:3:3 palette colour
  275. Compression    : none
  276.           runlength
  277. Recognition    : filetype &691
  278.  
  279. GIF
  280. ===
  281. Origin        : Various machines. Graphics Interchange Format, devised by
  282.           and copyright of Compuserve Incorporated.
  283. Colours        : 1,2,3,4,5,6,7,8 bpp 8:8:8 palette colour
  284. Compression    : 12-bit LZW
  285. Recognition    : filetype &695
  286.           'GIF87a' or 'GIF89a' at offset &0
  287. Miscellaneous    : When reading, any GIF89a extensions are skipped and
  288.           ignored. When writing, GIF87a format is always used.
  289. Save options    : 'Interlacing' defines whether or not an interlaced image is
  290.           saved. 'Interlacing = Yes' will save an interlaced image,
  291.           'Interlacing = No' won't.
  292.  
  293. IFF
  294. ===
  295. Origin        : Various machines. Interchange Format File, devised by
  296.           Electronic Arts.
  297. Colours        : 1,2,3,4,5,6,7,8 bpp 4:4:4 palette colour
  298.           1,2,3,4,5,6,7,8 bpp 8:8:8 palette colour
  299.           12 bpp 4:4:4 true colour
  300.           24 bpp 8:8:8 true colour
  301. Compression    : none
  302.           runlength
  303. Recognition    : filetype &693
  304.           'FORM' at offset &0 and 'ILBM' at offset &8
  305.  
  306. IMG
  307. ===
  308. Origin        : Atari and IBM compatible machines. Digital Research GEM
  309.           programs.
  310. Colours        : 1 bpp 8:8:8 grey
  311. Compression    : various methods
  312. Recognition    : filetype &692
  313.  
  314. Irlam
  315. =====
  316. Origin        : Acorn machines. Irlam video digitiser.
  317. Colours        : 24 bpp 8:8:8 grey
  318. Compression    : none
  319. Recognition    : filetype &69B
  320.           'Irlam' at offset &0
  321.  
  322. JPEG
  323. ====
  324. Origin        : Various machines. Joint Photographic Expert Group, the
  325.           actual format is called JFIF (JPEG File Interchange
  326.           Format), devised by C-Cube Microsystems.
  327. Colours        : 8 bpp 8:8:8 grey
  328.           24 bpp 8:8:8 true colour
  329. Compression    : Baseline JPEG
  330. Recognition    : filetype &C85
  331.           &FF, &D8 at offset &0
  332. Save options    : 'Quality = xx', where xx = 0..100, sets the quality level.
  333.           100 is best quality, lowest compression. 0 is worst
  334.           quality, highest compression. 'Optimize' switches on/off
  335.           compression optimization (switching it on results in
  336.           somewhat smaller files but also uses more processing time).
  337.           'Optimize = Yes' switches on compression optimization.
  338.           'Optimize = No' switches it off.
  339. Miscellaneous    : Reading and writing of this format is via external
  340.           programs, which have been written by the Independent JPEG
  341.           Group. The version of the software is 6a (07 Feb 1996).
  342.           I am required to state that 'This work is based in part on
  343.           the work of the Independent JPEG group'.
  344.  
  345. MacPaint
  346. ========
  347. Origin        : Apple MacIntosh machines. MacPaint program.
  348. Colours        : 1 bpp 8:8:8 grey
  349. Compression    : runlength
  350. Recognition    : filetype &694
  351.           'PNTG' at offset &41
  352. Miscellaneous    : resolution always 576 x 720 pixels
  353.  
  354. MTV
  355. ===
  356. Origin        : Various machines. MTV ray tracer.
  357. Colours        : 24 bpp 8:8:8 true colour
  358. Compression    : none
  359. Recognition    : filetype &699
  360.  
  361. PBMPlus
  362. =======
  363. Origin        : Unix machines. Portable Bit Map set of conversion programs,
  364.           devised by Jef Poskanzer.
  365. Colours        : 1,2,3,4,5,6,7,8 bpp 8:8:8 grey
  366.           24 bpp 8:8:8 true colour
  367. Compression    : none
  368. Recognition    : filetype &69E
  369.           'Px' at offset &0, where x = 1,2,3,4,5,6
  370.  
  371. PCX
  372. ===
  373. Origin        : IBM compatible machines. ZSoft PC Paintbrush program.
  374. Colours        : 1,2,4,8 bpp 8:8:8 palette colour
  375. Compression    : none
  376.           runlength
  377. Recognition    : filetype &697
  378.  
  379. Pineapple
  380. =========
  381. Origin        : Acorn machines. Pineapple Software video digitiser.
  382. Colours        : 16 bpp 5:6:5 true colour
  383. Compression    : none
  384. Recognition    : filetype &696
  385.           'FSIfile' at offset &0
  386. Miscellaneous    : resolution always 512 x 256 pixels
  387.  
  388. QRT
  389. ===
  390. Origin        : Various machines. QRT ray tracer.
  391. Colours        : 24 bpp 8:8:8 true colour
  392. Compression    : none
  393. Recognition    : filetype &698
  394.  
  395. Sprite
  396. ======
  397. Origin        : Acorn machines. Acorn defined native image format.
  398. Colours        : 1,2,4,8 bpp 4:4:4 palette colour
  399.           1,2,4,8 bpp 8:8:8 palette colour
  400.           15 bpp 5:5:5 true colour
  401.           24 bpp 8:8:8 true colour
  402. Compression    : none
  403. Recognition    : filetype &FF9
  404. Load options    : 'Default palette' defines the palette to use when palette
  405.           colour sprites without a palette are loaded. If the mapping
  406.           of the bpp of the input to the corresponding mode is
  407.           thought of as 1,2,4,8 bpp --> mode 18,19,20,21, then
  408.           'Default palette = WIMP' will use the default WIMP palette
  409.           for the appropriate mode, and 'Default palette = Mode' will
  410.           use the default mode palette (as after a MODE command
  411.           outside the desktop).
  412. Save options     : 'Sprite type' defines the sprite type to save. It only
  413.           affects the mode number saved in the sprite file. 'Sprite
  414.           type = Default' will save old type sprites for 4:4:4
  415.           palette colour input, else new type sprites. 'Sprite type =
  416.           Force old' will always save old type sprites. 'Sprite type
  417.           = Force new' will always save new type sprites.
  418. Miscellaneous    : Old type 8 bpp sprites with a 64-entry 4:4:4 palette can be
  419.           loaded, but cannot be saved because its palette cannot be
  420.           freely defined.
  421.  
  422. TIFF
  423. ====
  424. Origin        : Various machines. Tag Image File Format (that's 'Tag', not
  425.           'Tagged' as most people think !), devised by Aldus
  426.           Corporation and Microsoft Corporation.
  427. Colours        : 1,2,4,8 bpp 8:8:8 palette colour
  428.           24 bpp 8:8:8 true colour
  429. Compression    : none
  430.           packbits
  431.           12-bit LZW
  432. Recognition    : filetype &FF0
  433.           'II' or 'MM' at offset &0
  434.  
  435.  
  436. //
  437. //
  438. // Registering
  439. //
  440. //
  441.  
  442. To register, send 30 Dutch Guilders to :
  443.  
  444. John Kortink
  445. Nutterbrink 31
  446. 7544 WJ Enschede
  447. The Netherlands
  448.  
  449. As soon as your registration has been received you will be a registered user
  450. of Creator, and a floppy disc with the latest version of Creator will be sent
  451. to you free of charge. Registration also entitles you to free use of any
  452. future versions of Creator.
  453.  
  454. I can accept any of the following types of payment (in order of preference) :
  455.  
  456. - Cash. You may send any regular European currency, as long as it is
  457.   equivalent to 30 Dutch Guilders and consists of 'large', recent bank notes
  458.   only.
  459. - Eurocheque. Please note down your pass number on the back of the cheque or
  460.   I will be unable to cash the cheque at the bank.
  461.  
  462. Please note that I cannot accept any other type of payment, including cheques
  463. that are not Eurocheques. I cannot cash these cheques without paying high
  464. bank charges.
  465.  
  466. Updates of Creator will be made available by (in order of preference) :
  467.  
  468. - World Wide Web, on www.inter.nl.net/users/J.Kortink.
  469. - Electronic mail, to kortink@inter.nl.net.
  470. - Snail mail, to : see registration address. Include a DD or HD floppy,
  471.   return envelope and one International Reply Coupon (IRC).
  472.  
  473.